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Abstract 

With the prohferation of cheaper electronic devices, wireless commu- 
nication over multiple-channels in a multi-interface network is now pos- 
sible. For instace, wireless sensor nodes can now operate over multiple- 
channels. Moreover, cognitive radio sensor networks are also evolving, 
which also operates over multiple-channels. In the market, we can find 
antennas that can support the operation of multiple channels, for e.g. 
the cc2420 antenna that is used for communication between wireless sen- 
sor nodes consists of 16 programmable channels. The proper utilization of 
multiple-channels reduces the interference between the nodes and increase 
the network throughput. Recently, a Cognitive Radio Cognitive Network 
(CRCN) patch for NS-2 simulator has proposed to support multi-channel 
multi-interface capability in NS-2. 

In this tutorial, we consider how to simulate a multi-channel multi- 
interface wireless network using the NS-2 simulator. This tutorial is 
trageted to the novice users who wants to understand the implementation 
of multi-channel multi-interface in NS-2. We take the Cognitive Radio 
Cognitive Network (CRCN) patch for NS-2 simulator and demonstrate 
broadcasting over multiple-channels in a multi-interface network setting. 
In our seeting, node braodcasts the Hello packets to its neighbors. Neigh- 
boring nodes receive the Hello packets if and only if they are tuned to 
the same channel. We demonstrate through example that the tuning of 
receivers can be done in two fashions. 



1 Introduction 

The Network Simulator (NS-2) [1] is a most widely used network simulator. 
This tutorial uses the implementation of WCETT [2] based multi-channel wire- 
less mesh protocol in the Cognitive Radio Cognitive Network (CRCN) [3] patch 
developed for NS-2. The expected audience arc students who want to under- 
stand the broadcasting mechanism in multi-channel multi-interface environment 
in NS-2. The version considered is NS-2. 32 and 2.33, but it might be useful to 
other versions as well. Throughout the rest of this tutorial, the under consid- 
ered files are wcett.cc, wcett.h, wcett_logs.cc, wcett.packet.h, wcett_rqueue.cc, 
wcett_rqueue.h, wcett_rtable.cc, wcett_rtablc.h, which can be found in WCETT 
folder in the NS-2 base directory. The tcl file test4wcett.tcl can be found in the 
NS-2 based directory. Other relevant files are phy.cc and wireless-phy.cc. 

2 Methodology 

Our goal is to broadcast Hello packets over multiple interfaces. The methodology 
we adopted is to use Hello packets and broadcast them over multiple interfaces. 
We then demonstrated that a specific channel can be assigned to a particular 
interface. This assigned can be done either directly at the lower layer or can be 
communicated from the routing layer to the lower layer. We now describe the 
relevant section of codes. 



2.1 Modifications in TCL file test4wcett.tcl 

We use the TCL file test4wcett.tcl present in the NS-2 folder. WCETT is used 
as a routing protocol, whose code is quite similar to AODV and having the 
additional capability of calculating WCETT metric and can be able to pass 
channel selection information to lower layers. IEEE 802.11 mac is selected as 
mac protocol. The total number of interfaces of each node is selected as 3 in 
the tcl script: 
set val(ni) 3; 

2.2 How to Enable Hello Packets 

By default HELLO packets are disabled in the wcett protocol. To enable broad- 
casting of Hello packets, comment the following two lines present in wcett. cc 
#ifndef WCETT_LINK_LAYER_DETECTION 

#endif LINK LAYER DETECTION and recompile NS-2 by using the following 
commands on the terminal: 
make clean 
make 
sudo make install 



2.3 How to Send Hello Packets on a Specific Channel over 
Multiple Interfaces 



2825 

2e2E iffnlfaces] 

2827 { 

2028 //carmen 

2829 forfint 1=0 ;i<nlf aces ;l-n-} 

2838 { 

2031 Packet 'p_copy=p->copy() : 

2832 struct hdrcmr *ch_cop/ = HDK_CMN(p_copy) : 

2033 ch CDpy->channelindex = 1; 

2834 printf ("serdHello from index: %d using channel: %d interface: %d \n". index, ch_copy->channelindex_, i); 

2835 Scheduler: :instance[) .3chedule(targetlist [i] , pcopy, 0.0); 
2036 } 

2837 } 
203Q else 

2839 { 

284B Scheduler: :irstance[ J .schedule(target_, p, Q.Q): 
2041 } 
2842 } 
2843 

MM 

Figure 1: SendHello() function in the wcett. cc file. 



In order to send Hello packets on a specific channel over multiple interfaces, 
we need to assign the specific channel. This assignment of channel can be done 
by using the following variable: 

ch_copy— > channelindex- 



This channel value will then used by the network interface (phy.cc file) to 
select a channel for sending the packets. We can check how packets are trans- 
mitting on a specific channel over multiple interfaces by adding some lines in 
ScndHcllo() function of wcett.cc file (cf. Fig.[T|). In Fig. [I] the lines from 2026 to 
2041 send Hello packets over multiple interfaces. Note that if we do not specify 
the channel selection explicitly, as we mentioned on line 2033 (channel # 1), 
nodes will send the packet automatically on the channel decided at the lower 
layers. 

We can also see how nodes receives the hello packets by using printf command 
in recvHelloO function present in the wcett.cc file (cf. FiK.[2|. 



2867 

2668 //record the heUocounter for each neighbor on each channel 

2S69 if(nlfaces){ 

287B irrt lface^HDR_CMN(p)->localif(); 

2B71 ++ChannelErr[rp->rp_(ist] [iface] ; 

2B72 printf ("recvHello at: %d using channel: %d and interface: -tdXn", index, chteiip->channelindex_, if ace] ; 

2B73 

2974 }| 

2B75 

Figure 2: RecvHello() function in the wcett.cc file. 



2.4 Ways of Selecting the Channel 

There are two ways to select the channel value: 

1 . The routing layer decide the channel and communicate this information to 
lower layer. Note that this is done by adding a field in the packet header. 
Lower layer can use this channel decision value from the packet header. 
This channel selection decision value can be used to select the channel 
of the current node by making the following change in phy.cc file at the 
beginning of its recv() function: 

nchannel — hdr~ > channelindexj, 

which changes the current channel value to equal channelindex- value 
passed from WCETT routing layer or simply wcett.cc. 

2. We can assign some channels to some specific nodes. For e.g. we can select 
the channel for node 7's interfaces and for all other nodes, the selected 
channel value is 1. This could be done by adding the following lines at 
the start of the recv() function in phy.cc 

if {node{)~ > nodeidQ == 7) 

nchannel ~ 0; 

else 

nchannel = 1; 



If we make the above changes, channel is assigned to node 7, while channel 
1 is assigned to all the remaining nodes. 

2.5 Modifications in wireless-phy.cc file 

In order to tune an interface based on the channel value passed from the routing 
layer (i.e. wcett.cc), we are required to make the following change in sendUp 
function of wireless-phy.cc file. The lines 430-431 (cf. Fig. [3]) tunes the interface 
to the channel decision communicated from the routing layer. 



if (nchanneT. != hdr ^channelinde: 



ly do Colli 



* i"t can prope-rLy 

*/ 

( [MQbi^eNQde*)nQdet J>-=-Pacle&l:Pr_. Inc reaseTraTTlcCDunlit > 

p-=l:xliiro_.geXAnreiina( 1 -:»release(l : 

/* WILD HACK; The following two variables are a wild ha 
They will go away In the next release... 
They "re used by the mac- S02_l 1 object to determine 
capture . This will be moved 
objects In the "future. */ 

p-=-t>tinfo .CPThresh = CPThresh 



if family of 



entnode=node! J -;>nodeidi ) 



Figure 3: SendUp() function in the wireless-phy.cc file. 



3 Conclusion 

In this tutorial, wc showed that how broadcasting of packets can be done 
in multi-interface network setting in NS-2. Moreover, we also demonstrated 
through a working example that an interface can be tuned to a particular chan- 
nel based on the channel value passed from the routing layer (that is wcett.cc). 
One can also perform complete broadcast by broadcasting over all the available 
channels. 
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